.\"   $Id: GENLIB_UNFLATTEN_LOFIG.3,v 1.1 2002/03/08 14:08:11 fred Exp $
.\" @(#)GENLIB_UNFLATTEN_LOFIG.3 2.11 91/08/22; Labo Cao-vlsi; Author : Frederic Petrot
.if t \{\
.so man1/alc_contents.mac
.XS \n%
.ti 0.2i
GENLIB_UNFLATTEN_LOFIG
.XE \}
.TH GENLIB_UNFLATTEN_LOFIG.3 "October 1, 1997" "ASIM/LIP6" "PROCEDURAL GENERATION LANGUAGE"
.SH NAME
\fBUNFLATTEN_LOFIG\fP \- creates a hierarchy level from instances in the current logical figure
.SH SYNOPSIS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include <genlib.h>
void GENLIB_UNFLATTEN_LOFIG(figurename, instancename, list_of_instances, 0)
char \(**figurename;
char \(**instancename;
char \(**list_of_instances;
.ft R
.fi
.so man1/alc_origin.1
.SH PARAMETERS
.TP 20
\fIfigurename\fP
Name of the figure of the new hierarchy to be created
.TP
\fIinstancename\fP
Name to be given at the instantiation of \fIfigurename\fP into the current
structual figure
.TP
\fIlist_of_instances\fP
List of strings representing the instances to be inserted into the new figure
.SH DESCRIPTION
\fBUNFLATTEN_LOFIG\fP creates a new level of hierarchy, whose model name will
be \fIfigurename\fP, and instantiate it under the name \fIinstancename\fP in
the current figure.
The instances whose name belong to the \fIlist_of_instances\fP parameters are
added in the new figure, and destroyed from the current figure.
.SH EXAMPLE
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include <genlib.h>
main()
{
	/\(** Create a figure to work on  \(**/
	GENLIB_DEF_LOFIG("mycell");
	.
	.
	.
	/\(** Place an instance \(**/
	GENLIB_LOINS("model","instance", "sig1", "sig2", EOL);
	/\(** flatten an instance \(**/
	GENLIB_UNFLATTEN_LOFIG("newfig", "newins", "instance", ..., 0);
	/\(** Save all that on disk \(**/
	GENLIB_SAVE_LOFIG();
}
.ft R
.fi
.SH SEE ALSO
.BR genlib (1),
.BR GENLIB_FLATTEN_LOFIG (3).


.so man1/alc_bug_report.1

